# Reject a signup request

Rejects a pending signup request and permanently removes it from the queue. Sends a rejection email to the applicant with an optional reason for the rejection. This action is final and the user would need to submit a new signup request. The rejection is logged for audit purposes.

RBAC: requires Signups.Manage

Endpoint: PUT /api/v1/admin/signup_requests/reject/{hash}
Version: 1.0
Security: header

## Path parameters:

  - `hash` (string, required)

## Query parameters:

  - `reason` (string,null)
    Optional reason for rejection to include in the notification email. Helps users understand why their request was denied.

## Response 400 fields (application/json):

  - `errorCode` (string, required)
    Error code

  - `message` (string, required)
    Error message

  - `docUrl` (string)
    Link to documentation

## Response 403 fields (application/json):

  - `errorCode` (string, required)
    Error code

  - `message` (string, required)
    Error message

  - `docUrl` (string)
    Link to documentation

## Response 404 fields (application/json):

  - `errorCode` (string, required)
    Error code

  - `message` (string, required)
    Error message

  - `docUrl` (string)
    Link to documentation